\section{writem --- write matrix to file}
\label{fn:writem}
\index{writem()}
\index{writing a matrix to a file}
\index{matrix!output}
\index{matrix!saving in a file}
\begin{rail}
WriteMatrix : 'writem' '(' String ',' Matrix ')' ;
\end{rail}

\verb+writem+ is used to write a matrix to a file.  The output is
intended to be compatible with both the \verb+readm+ function and
several other programs, such as MATLAB$^{TM}$, and spreadsheets.  

Each line in the output file contains all the values for the
corresponding row in the matrix argument.  The values within each line
are delimited by whitespace.  \verb+writem+ will output all kinds of
matricies, but \verb+readm+ can only read numeric matricies with real
values.

\paragraph{Example}
\index{example of writem()}
\index{writem()!example}
\begin{verbatim}
Dummy Example
\end{verbatim}

See also: Page~\pageref{fn:close} \verb+close()+,
Page~\pageref{fn:read} \verb+read()+,
Page~\pageref{fn:readm} \verb+readm()+,
Page~\pageref{fn:write} \verb+write()+.

\newpage


